home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 036a / pmfinder.zip / PMFINDER.DOC < prev    next >
Text File  |  1991-12-05  |  4KB  |  105 lines
  1. DISCLAIMER
  2. ----------
  3. The Program is supplied "AS IS" without any warranty of any kind,
  4. either expressed or  implied,  including, but not limited to, the
  5. implied warranties of merchantability and fitness for a particular
  6. purpose.
  7.  
  8. In  no  event  shall Robert Mahoney be liable for any damages, either
  9. direct or  consequential,  caused by the use, or inability to use,
  10. this program, even  if Robert Mahoney has been advised of the
  11. possibility of such damages.
  12.  
  13.  
  14. INTRODUCTION
  15. ------------
  16. I had the source code to a single-threaded PM file finder and quite
  17. a while ago make it multi-threaded.  I didn't bother to release it
  18. because it looked like others had already done so.  I recently got
  19. the source to a DOS file finder that searches inside archives.  I
  20. added that functionality to the PM file finder and since I haven't
  21. seen any others that do this I decided to release it along with
  22. the source code.
  23.  
  24. ACKNOWLEDGEMENTS
  25. ----------------
  26.     The original file finder code was written by Jerry Weldon.
  27.     The archive search comes from a DOS file finder by Don A. Williams.
  28.     The listbox's colored text are from Pete Fitzsimmons's
  29.     PMSNOOP.
  30.     All I did was put them together.
  31.  
  32. INSTRUCTIONS
  33. ------------
  34.  
  35.   Place PMFINDER.EXE on your PATH.
  36.   At a command prompt type "start PMFINDER"
  37.   or put PMFINDER.EXE as an entry in one of your groups.
  38.  
  39. USAGE
  40. -----
  41.    Start PMFINDER or run it from a group.
  42.    Enter the file mask you would like to search for in the PATTERN field
  43.    Check box if you want to search archive files.
  44.    Select archive files you would like to select and whether you
  45.    want to search *only* archive files or *also* archvive file along
  46.    with regular files.
  47.    Press SEARCH.
  48.    The SEARCH Button now changes to STOP.
  49.    Regular files show up BLUE on WHITE.
  50.    Files inside ZIPs show up RED on WHITE.
  51.    Files inside LZHs show up BLACK on WHITE.
  52.    Files inside ARCs and PAKs show up GREEN on WHITE.
  53.    Errors show up BLACK on CYAN
  54.    To prematurely end the search press STOP.
  55.    The STOP Button now changes to SEARCH.
  56.  
  57. BUGS/LIMITATIONS
  58. ----------------
  59. 1) When you run out of memory adding items to the listbox
  60.    you will get two message boxes saying that you are out of
  61.    memory.  One from the regular file search thread and one from
  62.    the archive threads.  This does not happen when you do an archive
  63.    only search.  I'm sure it is an easy fix but I'm out of time.
  64.  
  65. 2) There are some limitations with large ZIP file searching.  It is
  66.    documented in the ZIP.C file.
  67.  
  68. 3) The worker threads should be changed to non-message queues.
  69.    This is documented in the file SCAN.C.  It was just a quick
  70.    and easy way to avoid posting messages and using a circular buffer.
  71.    This is left to the enterprising programmer.  Not a big job, it
  72.    is well implemented in Stephen Best's OS/2 Threads Cookbook
  73.    available on BIX and OS/2 Shareware BBS as COOKBO.ZIP.
  74.  
  75. 4) The original DOS file finder by Don A. Williams also can search
  76.    inside ZOO archives.  Since I had no ZOO files to test, I didn't
  77.    add it.  I did add Don's ZOO code to the PMFINDER archive.
  78.    Again, a simple exercise for the motivated programmer.
  79.  
  80. 5) The same code is used for ARC and PAK.  I was unable to test this
  81.    because I have no PAK files.
  82.  
  83. 6) PMFINDER crashes while checking invalid LZH files.  There seems like
  84.    there is no way to check to see if the LZH file has a vaild header.
  85.    Then again, I really didn't spend anytime looking at this.
  86.  
  87. 7) The header files are real convoluted.  I didn't get a chance to
  88.    use #IFDEFs and get them into shape.
  89.  
  90. 8) Sometimes the color of the listbox items initially display as
  91.    an incorrect color.  If you click on it or scroll it will display
  92.    the correct color.  I have no clue why.
  93.  
  94.    If anyone has some comments or improvements,
  95.    I can be reached on:
  96.  
  97.    Fidonet OS/2 echos:  OS/2 Shareware  (1:109/347)
  98.                         703-385-0931 (HST DS)
  99.                         703-385-4325 (HST DS)
  100.    BIX as RMAHONEY
  101.  
  102.         Robert Mahoney
  103.         27 East Jackson Ave
  104.         Babylon, New York 11702
  105.